home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / FAQs / SGIfaqs / SGI-Graphics-faq < prev    next >
Text File  |  1996-11-11  |  75KB  |  2,016 lines
  1.  
  2. From: sgi-faq@viz.tamu.edu (The SGI FAQ group)
  3. Newsgroups: comp.sys.sgi.misc,comp.answers,news.answers
  4. Subject: SGI graphics Frequently Asked Questions (FAQ)
  5. Supersedes: <graphics_786697207@viz.tamu.edu>
  6. Followup-To: comp.sys.sgi.misc
  7. Date: 20 Dec 1994 06:57:02 GMT
  8. Organization: Visualization Lab, Texas A&M University
  9. Lines: 1997
  10. Approved: news-answers-request@mit.edu
  11. Expires: 17 Jan 1995 07:00:07 GMT
  12. Message-ID: <graphics_787906807@viz.tamu.edu>
  13. Reply-To: sgi-faq@viz.tamu.edu (The SGI FAQ group)
  14. NNTP-Posting-Host: viz.tamu.edu
  15. Originator: sgi-faq@viz
  16.  
  17. Archive-name: sgi/faq/graphics
  18. Last-modified: Sat Dec 17 12:14:13 CST 1994
  19.  
  20.     SGI graphics Frequently Asked Questions (FAQ)
  21.  
  22. This is one of the Silicon Graphics FAQ series, which consists of:
  23.  
  24.     SGI admin FAQ - IRIX system administration
  25.     SGI apps FAQ - Applications and miscellaneous programming
  26.     SGI audio FAQ - Audio applications and programming
  27.     SGI graphics FAQ - Graphics and user environment customization
  28.     SGI hardware FAQ - Hardware
  29.     SGI impressario FAQ - IRIS Impressario
  30.     SGI inventor FAQ - IRIS Inventor
  31.     SGI misc FAQ - Introduction & miscellaneous information
  32.     SGI movie FAQ - Movies
  33.     SGI performer FAQ - IRIS Performer
  34.     SGI pointer FAQ - Pointer to the other FAQs
  35.  
  36. Read the misc FAQ for information about the FAQs themselves.  Each FAQ
  37. is posted to comp.sys.sgi.misc and to the news.answers and comp.answers
  38. newsgroups (whose purpose is to store FAQs) twice per month.  If you
  39. can't find one of the FAQs with your news program, you can get it by
  40. anonymous FTP from one of these sites:
  41.  
  42.     viz.tamu.edu:/pub/sgi/faq/
  43.     rtfm.mit.edu:/pub/usenet/news.answers/sgi/faq/
  44.     ftp.uu.net:/usenet/news.answers/sgi/faq/
  45.  
  46. Note that rtfm.mit.edu is home to many other FAQs and informational
  47. documents, and is a good place to look if you can't find an answer here.
  48. If you can't use FTP, send mail to mail-server@rtfm.mit.edu with the
  49. word 'help' on a line by itself in the text, and it will send you a
  50. document describing how to get files from rtfm.mit.edu by mail. Send the
  51. command 'send usenet/news.answers/sgi/faq/misc' to get the SGI misc FAQ,
  52. and similarly for the other FAQs. Finally, the FAQs are on the World
  53. Wide Web at
  54.  
  55.     http://www.cis.ohio-state.edu/hypertext/faq/usenet/sgi/top.html
  56.  
  57. The SGI FAQs are freely distributable and we encourage wide circulation.
  58. You MUST keep the FAQs intact, including headers and this notice.  The
  59. contents are accurate as far as we know, but the usual disclaimers
  60. apply. (In particular, copies of the SGI FAQs published on paper or
  61. CD-ROM are certain to be out of date!) Please send additions and changes
  62. to sgi-faq@viz.tamu.edu.
  63.  
  64. Topics covered in this FAQ:
  65. ---------------------------
  66.    -1- DISPLAYS AND DGL
  67.    -2- How can I run a program on one machine and display it on another?
  68.    -3- Does the DISPLAY environment variable work for GL applications?
  69.    -4- Why doesn't the DISPLAY environment variable seem to work?
  70.    -5- Why do I get DGL errors when I try to run a GL program?
  71.    -6- CUSTOMIZING
  72.    -7- What tools does SGI provide to help with the customization
  73.        process?
  74.    -8- What are the important login and resource files for IRIX 4.0.x?
  75.    -9- What is the sequence of events that occur at login time in IRIX
  76.        4.0.x?
  77.   -10- What is the difference between .xsession and .sgisession in IRIX
  78.        4.0.x?
  79.   -11- Why do 4Dwm, toolchest, Workspace, etc. not recognize an
  80.        environment variable I set in my shell's startup files in IRIX
  81.        4.0.x?
  82.   -12- How can I save my screen layout in IRIX 4.0.x?
  83.   -13- How can I turn off the IRIX 5.2 Magic user environment?
  84.   -14- Where is the default value of PATH set?
  85.   -15- Why can't I log in after copying /usr/lib/X11/xdm/Xsession to
  86.        .xsession?
  87.   -16- How can I find out what fonts are available?
  88.   -17- How can I use the Alt key as a Meta key in an xwsh window?
  89.   -18- How can I configure my keyboard like a VT100?
  90.   -19- RESOURCES
  91.   -20- What are resources?
  92.   -21- How can I set resources?
  93.   -22- How can I use resources to run the same program twice with
  94.        different attributes?
  95.   -23- Does the GL recognize resources?
  96.   -24- How can I know what resources I can set for an application?
  97.   -25- What is a good approach to take in looking for resources?
  98.   -26- What is the precedence for resource files?
  99.   -27- Why do long resources cause X to crash mysteriously in IRIX 5.2?
  100.   -28- 4DWM
  101.   -29- Where can I learn more about the Window Manager?
  102.   -30- What files affect the window manager and what is their
  103.        relationship to each other?
  104.   -31- Do I need my own .4Dwmrc file?
  105.   -32- Can I run a different window manager?
  106.   -33- How can I choose a different window manager as the default?
  107.   -34- How can I recover from a failed window manager customization
  108.        attempt?
  109.   -35- Why is an extra 4Dwm burning CPU in IRIX 4.0.x?
  110.   -36- Why doesn't the window manager's "Log Out" routine work in IRIX
  111.        4.0.5?
  112.   -37- ADMINISTRATION
  113.   -38- How can I log into pandora/clogin without bringing up graphics?
  114.   -39- How can I restart the console?
  115.   -40- How can I start and stop the graphics system?
  116.   -41- How can I kill the X server without logging in or rebooting?
  117.   -42- How can I run 'xinit' manually, rather than automatically from
  118.        'xdm'?
  119.   -43- How can I start X on a remote host with no users logged in?
  120.   -44- IMAGE FILES
  121.   -45- How can I convert images to and from other formats?
  122.   -46- What is the format of SGI's RGB files?
  123.   -47- How can I compress RGB bitmaps?
  124.   -48- How can I make a screen dump?
  125.   -49- PROGRAMMING
  126.   -50- Can I use 4Dgifts code in my application?
  127.   -51- What does ERR_WMANIPC mean?
  128.   -52- How can I translate screen (x,y) coords into world (x,y,z)
  129.        coords?
  130.   -53- How can I translate world (x,y,z) coords into screen (x,y)
  131.        coords?
  132.   -54- Why does nothing happen when I call mapcolor(index, R, G, B)?
  133.   -55- What's wrong with blink() in IRIX 4.0.x?
  134.   -56- Why can't 'cc' find some standard Xwindows functions?
  135.   -57- Where is the library /usr/lib/libgl_s.a for my R4000 Indigo
  136.        running IRIX 4.0.5F?
  137.   -58- What is a GL widget?
  138.   -59- I'm using the GlxMDraw widget and it doesn't seem that colors are
  139.        being installed correctly.  Overlays in the GlxMDraw widget are
  140.        displayed in red and gray instead of the colors I specify.
  141.        What's wrong?
  142.   -60- Is there a way to switch between single and double buffering
  143.        within a GL widget on the fly?
  144.   -61- Why doesn't my X server use backing store? How can I turn it on?
  145.   -62- What is "/dev/tport" used for?
  146.   -63- BUGS AND PROBLEMS
  147.   -64- Why do I get a "Broken Pipe" error when I close an X client
  148.        window?
  149.   -65- What do the errors in my 'xdm-errors' file mean?
  150.   -66- Why doesn't SGI's xlock lock my screen?
  151.   -67- Sun XView applications like "mailtool" hang my X server in IRIX
  152.        4.0.5.  They come up fine, but when I click on them the server
  153.        freezes.
  154.   -68- Why can't I log into Pandora in IRIX 4.0.1?
  155.   -69- Pandora won't come up, and /usr/adm/SYSLOG says "helvetica font
  156.        missing"
  157.   -70- Why does the X server sometimes abort when I log out in IRIX
  158.        5.0.1 and IRIX 5.1?
  159.   -71- After running a few programs, the colors change as the cursor
  160.        moves. The colors are usually all wrong in other windows.
  161.   -72- How can I make my X Server use a 12-bit PseudoColor, 12-bit
  162.        TrueColor or 24-bit TrueColor visual by default?
  163.   -73- When I try to run UIM/X uxserverd, I get an error message saying,
  164.        "license file has been modified, cannot start the UIM/X license
  165.        server".
  166.   -74- MISCELLANEOUS
  167.   -75- What books about the X Window System and OSF/Motif do you
  168.        recommend?
  169.   -76- Does the IRIX 5.2 Magic user environment display on an X
  170.        terminal?
  171.   -77- What about OpenGL?
  172.   -78- Which SGI machines can run OpenGL now? Which will in the future?
  173. + -79- What's this about a copyright dispute over virtual desks in
  174.        Indigo Magic?
  175.  
  176. ----------------------------------------------------------------------
  177.  
  178. Subject:    -1- DISPLAYS AND DGL
  179. Date: + 15 May 94 00:00:01 EST
  180.  
  181.   This section discusses how to use remote displays.
  182.  
  183. ------------------------------
  184.  
  185. Subject:    -2- How can I run a program on one machine and display it on
  186.                 another?
  187. Date: 07 May 93 00:00:01 EST
  188.  
  189.   Use the DISPLAY environment variable to specify the remote host on
  190.   which you want the X client to be displayed, then run the
  191.   application.
  192.  
  193.   To specify the remote host,
  194.  
  195.       setenv DISPLAY <destination>:0
  196.  
  197.   where <destination> is the name or IP address of the remote host.  To
  198.   specify the local host (console),
  199.  
  200.       setenv DISPLAY :0
  201.  
  202. ------------------------------
  203.  
  204. Subject:    -3- Does the DISPLAY environment variable work for GL
  205.                 applications?
  206. Date: 07 May 93 00:00:01 EST
  207.  
  208.   Yes: IRIX 4.0.x and later uses the Distributed Graphics Library (DGL)
  209.   by default. DGL applications use the DISPLAY environment variable
  210.   just as do ordinary X applications.
  211.  
  212. ------------------------------
  213.  
  214. Subject:    -4- Why doesn't the DISPLAY environment variable seem to
  215.                 work?
  216. Date: 07 May 93 00:00:01 EST
  217.  
  218.   First, make sure your DISPLAY variable is syntactically correct.  For
  219.   example, to display applications on a machine named "enterprise",
  220.   whose IP address is 123.45.678.90, DISPLAY should be set to
  221.   "enterprise:0" or "123.45.678.90:0".
  222.  
  223.   Next, try to "ping" the machine to which your DISPLAY variable is
  224.   set.  If this does not work, you have either specified an invalid
  225.   hostname, the host is down, or you are having network problems.
  226.  
  227.   If you see messages like "permission denied" or "can't connect to
  228.   server", you have a permission problem.   Do 'xhost +yourmachine' on
  229.   the remote machine to give 'yourmachine' access to the remote
  230.   machine's display. (Note that 'xhost' is inactive by default on
  231.   SGIs.)
  232.  
  233.   If you're using NIS (YP), make sure the client is linked with
  234.   "-lsun".
  235.  
  236.   For more information see Chapter 3 of the X Window System User's
  237.   Guide.
  238.  
  239. ------------------------------
  240.  
  241. Subject:    -5- Why do I get DGL errors when I try to run a GL program?
  242. Date: 20 Feb 94 00:00:01 EST
  243.  
  244.   - There may be a problem with the DISPLAY variable or Xwindows
  245.     permissions. See the previous question.
  246.  
  247.   - You may be trying to display on a non-SGI machine which doesn't
  248.     have GL/DGL. (Most don't, yet.) Presently the only way around this
  249.     is to buy a third-party GL emulator for the non-SGI machine.
  250.  
  251.   - DGL may be disabled in /etc/services and/or /etc/inetd.conf. The
  252.     former file should have a line reading
  253.  
  254.       sgi-dgl         5232/tcp
  255.  
  256.     and the latter should have a line reading
  257.  
  258.       sgi-dgl stream  tcp   nowait  root   /usr/etc/dgld  dgld -IM -tDGLTSOCKET
  259.  
  260.     If either is commented out, remove the comment.
  261.  
  262.   - You may be trying to display on a machine with a much older version
  263.     of IRIX. Try another machine with a newer IRIX.
  264.  
  265.   An article in the Jan/Feb 93 Pipeline describes the above in great
  266.   detail.
  267.  
  268. ------------------------------
  269.  
  270. Subject:    -6- CUSTOMIZING
  271. Date: 15 May 94 00:00:01 EST
  272.  
  273.   This section discusses ways to customize your environment, both with
  274.   and without graphics. The next two sections go into depth on
  275.   customizing Xwindows resources and the 4Dwm.
  276.  
  277. ------------------------------
  278.  
  279. Subject:    -7- What tools does SGI provide to help with the
  280.                 customization process?
  281. Date: 05 Jul 94 00:00:01 EST
  282.  
  283.   Here are some good places to look in IRIX 4.0.x:
  284.  
  285.   - The Customization rollover menu in the Toolchest.
  286.   - The manpages for xfontsel, xlsfonts, xwininfo, xdpyinfo, xprop,
  287.     appres, listres, and xrdb.
  288.   - The "WorkSpace User's Guide".
  289.   - The example files in /usr/tutor/Customize.
  290.  
  291.   In IRIX 5.x, take the systemtour and keep your eyes open.
  292.  
  293. ------------------------------
  294.  
  295. Subject:    -8- What are the important login and resource files for IRIX
  296.                 4.0.x?
  297. Date: 07 May 93 00:00:01 EST
  298.  
  299.   The following three file groupings indicate where files that affect
  300.   your login session reside.
  301.  
  302.   1) /usr/lib/X11/* - This is THE starting place. Here you find the
  303.   system default bindings for Motif, 4Dwm, and the Toolchest. The xdm
  304.   directory lives here as well as the app-defaults directory. xdm
  305.   controls the session management. Many application defaults are set in
  306.   the app-defaults directory.
  307.  
  308.   2) $HOME/[.Xdefaults, .4Dwmrc, .chestrc, .xsession, .sgisession] Here
  309.   you find the files that control your system set-up.  You create these
  310.   files; they don't exist when you first log in.
  311.  
  312.   3) /usr/bin/X11 - This is where the binaries live. It makes life nice
  313.   to include this directory in your path.
  314.  
  315. ------------------------------
  316.  
  317. Subject:    -9- What is the sequence of events that occur at login time
  318.                 in IRIX 4.0.x?
  319. Date: 10 Dec 93 00:00:01 EST
  320.  
  321.   This is a bare bones synopsis of the events that occur when you log
  322.   in to the console via xdm (the default method of logging in) under
  323.   IRIX 4.0.x and, with the desktop *disabled*, IRIX 5.x.
  324.  
  325.    1) Provide a "failsafe" (nographics) login if required/requested.
  326.    2) Exec $HOME/.xsession if it exists. If it exists, the remaining
  327.       steps should normally be included in the users .xsession file
  328.       as well.
  329.    3) Load $HOME/.Xresources if it exists.
  330.    4) Set XUSERFILESEARCHPATH.
  331.    5) Incorporate a "shell" environment into the "session".
  332.       (man userenv)
  333.    6) Set the root background and cursor.
  334.    7) Disable display access control (xhost +).  (man xhost)
  335.    8) Start 4Dwm.
  336.    9) Wait for 4Dwm to come up.
  337.   10) Start the console.
  338.   11) Execute $HOME/.sgisession if it exists.
  339.   12) Start WorkSpace if the user wants it.
  340.   13) Put a Toolchest on each screen.
  341.   14) Exec the "reaper". (man reaper / endsession)
  342.  
  343. ------------------------------
  344.  
  345. Subject:   -10- What is the difference between .xsession and .sgisession
  346.                 in IRIX 4.0.x?
  347. Date: 07 May 93 00:00:01 EST
  348.  
  349.   The system Xsession file (/usr/lib/X11/xdm/Xsession or
  350.   Xsession-remote) starts up a number of important things when you log
  351.   in, eg. 4Dwm, toolchest, loads resources, sets your
  352.   XUSERFILESEARCHPATH, sets your root background, etc.
  353.  
  354.   One of the last things it does is look in your home directory for a
  355.   .sgisession file.  This allows you to start additional programs at
  356.   login time. This is the file that you would use to start a mailbox,
  357.   additional window, a calendar, etc.
  358.  
  359.   ADVANTAGES OF $HOME/.sgisession :
  360.  
  361.       1) You don't need to read through yet another system file to see
  362.      what you need or don't need.
  363.  
  364.   DISADVANTAGES OF $HOME/.sgisession :
  365.  
  366.       1) You cannot override ALL of the defaults set for you. Some
  367.          things you can't change from a .sgisession file:
  368.  
  369.          A) You can't start a different window manager.
  370.          B) You can't change the way the console starts.
  371.          C) You can't change toolchest output redirection to
  372.         the console.
  373.  
  374.       2) Users of other vendors' equipment are used to seeing a
  375.      .xsession file.
  376.  
  377.   After checking for a "failsafe" (ie. no graphics) login, one of the
  378.   first things that /usr/lib/X11/xdm/Xsession does is check for
  379.   $HOME/.xsession.  If it exists, Xsession execs your .xsession file.
  380.   This means that if you are REALLY sure you know what you are doing,
  381.   you can log in with a different window manager, xterm as a console,
  382.   or xwsh not already iconified, etc.  You can also turn off the
  383.   toolchest output redirection, and start anything else you might have
  384.   done in $HOME/.sgisession. There is a discussion on xsession files in
  385.   volume 3 of the O'Reilly series.
  386.  
  387. ------------------------------
  388.  
  389. Subject:   -11- Why do 4Dwm, toolchest, Workspace, etc. not recognize an
  390.                 environment variable I set in my shell's startup files
  391.                 in IRIX 4.0.x?
  392. Date: 30 Apr 94 00:00:01 EST
  393.  
  394.   The script /usr/lib/X11/xdm/Xsession (or, if you have one, your own
  395.   ~/.xsession) runs when you log in and starts your window manager
  396.   (4Dwm), Workspace, etc. To give these programs a copy of the
  397.   environment you define in your shell's startup files, Xsession first
  398.   runs 'userenv', which runs your shell just to see what environment
  399.   variables your shell's startup files set and puts them into
  400.   Xsession's environment.  Later on Xsession runs 4Dwm, Workspace, etc.
  401.   and they inherit Xsession's environment including the environment
  402.   variables which 'userenv' got from your shell's startup files.
  403.  
  404.   However, 'userenv' objects to 1) errors in your shell startup files,
  405.   2) commands which print output to the terminal and 3) commands like
  406.   'stty' and 'tset', which expect to be connected to a terminal.  Any
  407.   of these may cause 'userenv' to give up completely, so that Xsession,
  408.   4Dwm, Workspace, etc. do not get any of your shell's enviroment.
  409.  
  410.   To get 'userenv' to work, you must 1) make sure that your shell
  411.   startup files are error-free and 2) protect 'userenv' from commands
  412.   which print output or expect to be connected to a terminal by testing
  413.   for the ENVONLY environment variable before running them. (See the
  414.   userenv(1) manpage.) You might try disabling your shell startup files
  415.   (or parts thereof) one by one to narrow down which is causing the
  416.   problem.  Be sure to check both personal and system-wide shell
  417.   startup files! See your shell's manpage for a complete list.
  418.  
  419.   Note that each terminal window (aka 'winterm', 'xwsh' or 'xterm')
  420.   runs a fresh copy of your shell, so it has a second chance to set
  421.   your environment variables. Your shell is now connected to a terminal
  422.   and 'userenv' isn't involved, so none of the above problems apply.
  423.   The environment in a terminal window will appear correct, and
  424.   programs started from a window (e.g. by typing 'workspace' to start
  425.   Workspace) will inherit the environment properly.  Furthermore,
  426.   'userenv' often appears to work when run inside a terminal window,
  427.   even when it does not work when run from Xsession.  This is all fine,
  428.   but it doesn't help when you log in. One right way to see if
  429.   'userenv' is working when it should is to add the line 'env >
  430.   $HOME/test-userenv' to Xsession after the line that runs 'userenv',
  431.   log in and examine the file it creates.
  432.  
  433.   'bash' users take note: 'bash' has particular problems with
  434.   'userenv', and there is a special version of 'userenv' which works
  435.   with 'bash' at
  436.   viz.tamu.edu:/pub/sgi/software/userenv/userenv.tar.gz.
  437.  
  438. ------------------------------
  439.  
  440. Subject:   -12- How can I save my screen layout in IRIX 4.0.x?
  441. Date: 07 May 93 00:00:01 EST
  442.  
  443.   Not very easily.  You must run "xwininfo" to find the X and Y
  444.   position of each window, then use that information to customize your
  445.   .sgisession or .xsession files.
  446.  
  447.   For more information see Chapter 3 of the X Window System User's
  448.   Guide, (Vol. 3 of the O'Reilly series)
  449.  
  450.   There are two tools that may help: 'xtoolplaces', which was posted to
  451.   volume 14 of comp.sources.x
  452.   (ftp.uu.net:/usenet/comp.sources.x/volume14/xtoolplaces/), and David
  453.   Hinds' 'xscript', which is at cb-iris.stanford.edu:/pub/.
  454.  
  455. ------------------------------
  456.  
  457. Subject:   -13- How can I turn off the IRIX 5.2 Magic user environment?
  458. Date: 18 Aug 94 00:00:01 EST
  459.  
  460.   Mark Andrews <mark@alias.com> says:
  461.   You can disable the Indigo Magic environment in two ways:
  462.  
  463.   1) If you wish to disable it for all users on the machine:
  464.  
  465.          chkconfig desktop off
  466.  
  467.   2) If you wish to disable it for a specific user, do
  468.  
  469.          touch ~<username>/.disableDesktop
  470.  
  471.      You may also have to remove the ~/.desktop-<hostname> directory as
  472.      well as 4Dwm looks in there for a 4Dwmsession file which it uses
  473.      for a guide to redisplay windows left open from the last session.
  474.  
  475.      Method 2 works ONLY if you have the original IRIX 5.2 xdm Xsession
  476.      file, which contains the following code chunk:
  477.  
  478.      if /etc/chkconfig desktop ;
  479.      then
  480.              if [ -x $0.dt -a \! -f $HOME/.disableDesktop ]
  481.              then
  482.                      exec $0.dt $*
  483.              fi
  484.      fi
  485.  
  486.   If you only want to turn off the file manager, create the file
  487.   ~/.desktop-<hostname>/nodesktop.
  488.  
  489.   Whether you disable the entire desktop or just the file manager, you
  490.   may also want to set one or more of these resources
  491.  
  492.      4DWm*SG_autoSave:       false
  493.      4Dwm*SG_manageSession:  false
  494.      4Dwm*SG_useBackgrounds: false
  495.  
  496.   which are explained in the 4Dwm(1) manpage. See also the desktop_eoe
  497.   release notes.
  498.  
  499. ------------------------------
  500.  
  501. Subject:   -14- Where is the default value of PATH set?
  502. Date: 10 Dec 93 00:00:01 EST
  503.  
  504.   Every program which allows a user to log in (telnet, rlogin, pandora,
  505.   etc.) can specify PATH. Shells may as well if it isn't already set.
  506.   There are many slightly different default values, and relying on them
  507.   is a good way to get confused. The only reliable method is to set
  508.   PATH in your shell's startup files. These are different for each
  509.   shell, and are described in each shell's manpage. Beware of 'ksh',
  510.   which has an internal, invisible default path ('/bin:/usr/bin') which
  511.   it uses when PATH is not set.
  512.  
  513. ------------------------------
  514.  
  515. Subject:   -15- Why can't I log in after copying
  516.                 /usr/lib/X11/xdm/Xsession to .xsession?
  517. Date: 07 May 93 00:00:01 EST
  518.  
  519.   After copying this file to your home directory, you need to remove
  520.   all references to "xsession". References to xsession cause the system
  521.   to try to execute $HOME/.xsession, which will create an infinite
  522.   loop.
  523.  
  524.   Remove the lines in ~/.xsession that say:
  525.  
  526.   if [ -r $xsession -a "$0" != $xsession ]; then
  527.          if [ -x $xsession ]; then
  528.              exec $xsession
  529.          else
  530.              exec /bin/sh $xsession
  531.          fi
  532.   fi
  533.  
  534. ------------------------------
  535.  
  536. Subject:   -16- How can I find out what fonts are available?
  537. Date: 07 May 93 00:00:01 EST
  538.  
  539.   The xfontsel and xlsfonts utilities help you find appropriate fonts.
  540.   xlsfonts lists the fonts; xfontsel provides an interface for
  541.   selecting a desired font. To use xfontsel, choose "Font Names" from
  542.   the Customization rollover menu in the Toolchest.  Please see the man
  543.   pages and the IRIS Utilities Guide for further information.
  544.  
  545. ------------------------------
  546.  
  547. Subject:   -17- How can I use the Alt key as a Meta key in an xwsh
  548.                 window?
  549. Date: 23 Jun 94 00:00:01 EST
  550.  
  551.   First, put the following X resources wherever you put X resources:
  552.  
  553.   --- beginning of resources ---
  554.   ! This turns Alt-key into Meta-key.
  555.  
  556.   XWsh*metaKeyMask:    8
  557.  
  558.   ! This allows multiple key modifiers in keybindings (so we can do
  559.   ! meta-shift, meta-control, etc. and incidentally a) turns vt100
  560.   ! cursor key mode off and b) changes the cursor key bindings.
  561.  
  562.   XWsh*keyboardType:    xlib
  563.  
  564.   ! This turns vt100 cursor key mode back on. Running 'tset' at login
  565.   ! resets the terminal and turns the cursor keys back off, so don't
  566.   ! run it.
  567.  
  568.   XWsh*initSequence:    \233?1h
  569.  
  570.   ! The iris-ansi terminfo entry has arrow key sequences for the ibmrt
  571.   ! keyboard, not the xlib keyboard; for curses applications to work,
  572.   ! the arrow keys must be bound to the sequences in the terminfo
  573.   ! entry. Rebinding the arrow keys to match the terminfo entry is more
  574.   ! convenient than changing the terminfo entry.
  575.  
  576.   XWsh*ckmeKeyMap:            \
  577.       Left(any): send("\033[D");        \
  578.       Right(any): send("\033[C");        \
  579.       Up(any): send("\033[A");        \
  580.       Down(any): send("\033[B");
  581.   --- end of resources ---
  582.  
  583.   'tset' resets your terminal, so running it will undo the initSequence
  584.   resource setting. There is a 'tset' command in the default csh/tcsh
  585.   ~/.login file; replace the line
  586.  
  587.       eval `tset -s -Q`
  588.  
  589.   with
  590.  
  591.       if (! $?TERM) then
  592.           eval `tset -s -Q`
  593.       endif
  594.  
  595.   so 'tset' will run only if the TERM environment variable isn't
  596.   already set. (You can't say 'if (! $?TERM) eval `tset -sQ`', because
  597.   csh/tcsh evaluates the backquotes *before* the if.)
  598.  
  599.   Finally, if you use GNU Emacs, put the following in your .emacs:
  600.  
  601.       (set-input-mode nil nil t)
  602.  
  603.   This tells Emacs to allow Meta key usage even though the iris-ansi
  604.   (xwsh) terminal description doesn't specify a Meta key.
  605.  
  606. ------------------------------
  607.  
  608. Subject:   -18- How can I configure my keyboard like a VT100?
  609. Date: 14 Jun 94 00:00:01 EST
  610.  
  611.   'xwsh -vt100' may be close enough; try it and see. (The PF keys are
  612.   mapped to F9-F12.) If not, use 'xterm' and put the following (from
  613.   Hemant Shah <shah@fnal.fnal.gov>) wherever you put the rest of your X
  614.   resources:
  615.  
  616.   === snip ===
  617.   XTerm*VT100.Translations: #override \
  618.       <Key>BackSpace:        string(0x7f) \n\
  619.       <Key>Num_Lock:        string(0x1b) string("OP") \n\
  620.       <Key>KP_Divide:        string(0x1b) string("OQ") \n\
  621.       <Key>KP_Multiply:    string(0x1b) string("OR") \n\
  622.       <Key>KP_Subtract:    string(0x1b) string("OS") \n\
  623.       <Key>KP_Add:        string(0x1b) string("Om") \n\
  624.       <Key>Pause:        string(0x1b) string("[34~") \n\
  625.       <Key>Print:        string(0x1b) string("[32~") \n\
  626.       <Key>Scroll_Lock:       string(0x1b) string("[33~") \n\
  627.       <Key>KP_0:        string(0x1b) string("Op") \n\
  628.       <Key>KP_1:        string(0x1b) string("Oq") \n\
  629.       <Key>KP_2:        string(0x1b) string("Or") \n\
  630.       <Key>KP_3:        string(0x1b) string("Os") \n\
  631.       <Key>KP_4:        string(0x1b) string("Ot") \n\
  632.       <Key>KP_5:        string(0x1b) string("Ou") \n\
  633.       <Key>KP_6:        string(0x1b) string("Ov") \n\
  634.       <Key>KP_7:        string(0x1b) string("Ow") \n\
  635.       <Key>KP_8:        string(0x1b) string("Ox") \n\
  636.       <Key>KP_9:        string(0x1b) string("Oy") \n\
  637.       <Key>KP_Decimal:    string(0x1b) string("On") \n\
  638.       <Key>Insert:        string(0x1b) string("[1~") \n\
  639.       <Key>Home:        string(0x1b) string("[2~") \n\
  640.       <Key>Prior:        string(0x1b) string("[3~") \n\
  641.       <Key>Delete:        string(0x1b) string("[4~") \n\
  642.       <Key>End:        string(0x1b) string("[5~") \n\
  643.       <Key>Next:        string(0x1b) string("[6~") \n\
  644.       <Key>F1:        string(0x1b) string("[17~") \n\
  645.       <Key>F2:        string(0x1b) string("[18~") \n\
  646.       <Key>F3:        string(0x1b) string("[19~") \n\
  647.       <Key>F4:        string(0x1b) string("[20~") \n\
  648.       <Key>F5:        string(0x1b) string("[21~") \n\
  649.       <Key>F6:        string(0x1b) string("[23~") \n\
  650.       <Key>F7:        string(0x1b) string("[24~") \n\
  651.       <Key>F8:        string(0x1b) string("[25~") \n\
  652.       <Key>F9:        string(0x1b) string("[26~") \n\
  653.       <Key>F10:        string(0x1b) string("[28~") \n\
  654.       <Key>F11:        string(0x1b) string("[29~") \n\
  655.       <Key>F12:        string(0x1b) string("[31~") \n\
  656.   === snip ===
  657.  
  658.   This remaps the keys as follows:
  659.  
  660. ----------------------------------------------------
  661.      SGI Key              |   Emulated VT100 key
  662. ----------------------------------------------------
  663.     Num Lock              |   PF1
  664.       /                   |   PF2
  665.       *                   |   PF3
  666.       -                   |   PF4
  667.       7                   |   7
  668.       8                   |   8
  669.       9                   |   9
  670.       +                   |   -
  671.       4                   |   4
  672.       5                   |   5
  673.       6                   |   6
  674.       1                   |   1
  675.       2                   |   2
  676.       3                   |   3
  677.     Enter                 |   Enter
  678.       0                   |   0
  679.       .                   |   .
  680.     Insert                |   Find
  681.     Home                  |   Insert Here
  682.     Page Up               |   Remove
  683.     Delete                |   Select
  684.     End                   |   Prev Screen
  685.     Page Down             |   Next Screen
  686.       F1                  |   F6
  687.       F2                  |   F7
  688.       F3                  |   F8
  689.       F4                  |   F9
  690.       F5                  |   F10
  691.       F6                  |   F11
  692.       F7                  |   F12
  693.       F8                  |   F13
  694.       F9                  |   F14
  695.       F10                 |   Help
  696.       F11                 |   Do
  697.       F12                 |   F17
  698.     Print Screen          |   F18
  699.     Scroll Lock           |   F19
  700.     Pause                 |   F20
  701.  
  702.   Any volunteers to work out similar bindings for xwsh?
  703.  
  704. ------------------------------
  705.  
  706. Subject:   -19- RESOURCES
  707. Date: + 15 May 94 00:00:01 EST
  708.  
  709.   This section discusses Xwindows resources.
  710.  
  711. ------------------------------
  712.  
  713. Subject:   -20- What are resources?
  714. Date: 07 May 93 00:00:01 EST
  715.  
  716.   Resources are "attributes" that control the look and feel of an
  717.   application. Resources include color, fonts, size, location, and
  718.   more.  Resources can have a complex format for binding strengths.
  719.  
  720.   For a complete description of resources, including a description of
  721.   "loose" and "tight" bindings, consult a book listed in the
  722.   bibliography question above.
  723.  
  724. ------------------------------
  725.  
  726. Subject:   -21- How can I set resources?
  727. Date: 07 May 93 00:00:01 EST
  728.  
  729.   There are many ways to set resources. Resources may be listed in
  730.   files or contained in a data base. Consult a book on X as well as the
  731.   xrdb(1) manpage for detailed descriptions.  Generally speaking, if
  732.   xrdb is not used, resource files are specified through environment
  733.   variables.  "What is a good approach to take in looking for
  734.   resources?" addresses the precedence of these files and variables.
  735.  
  736.   For some examples in IRIX 4.0.x, see the file
  737.   /usr/tutor/Customize/example.Xdefaults.
  738.  
  739. ------------------------------
  740.  
  741. Subject:   -22- How can I use resources to run the same program twice
  742.                 with different attributes?
  743. Date: 07 May 93 00:00:01 EST
  744.  
  745.   To accomplish this task, you need to take advantage of the "instance
  746.   vs class" concept. This concept is explained further in most books on
  747.   Xt.
  748.  
  749.   Many applications have a resource that lets you to give it a unique
  750.   name.  For example, from the xwsh man page :
  751.  
  752.   -name instance-name
  753.     Provide a unique name for an xwsh window.  This name becomes
  754.     the instance name of the specific xwsh, with the class name
  755.     always being "XWsh".
  756.  
  757.   Using the -name option allows you to give "names" to different
  758.   instances of xwsh and assign different resources to each one.  So if
  759.   you want two different xwsh's with different resource sets, give them
  760.   two different names, say howdymom and howdydoody, for example.  Add
  761.   the following to your ~/.Xdefaults file (if you use .Xdefaults) :
  762.  
  763.     howdymom*foreground:       SeaGreen
  764.     howdydoody*foreground:     SGIBeet
  765.  
  766.   Now all you have to do is start them up :
  767.  
  768.     xwsh -name howdymom&
  769.     xwsh -name howdydoody&
  770.  
  771. ------------------------------
  772.  
  773. Subject:   -23- Does the GL recognize resources?
  774. Date: 07 May 93 00:00:01 EST
  775.  
  776.   Yes. In IRIX 4.0 and later, the GL responds to several X resources,
  777.   allowing run-time control over some aspects of GL programs.
  778.  
  779.   The man page assumes you are somewhat familiar with X resources, if
  780.   you are not, you should read some X documentation such as Volume 3 of
  781.   the O'Reily X books.
  782.  
  783.   The GL uses resources names with the prefixes
  784.  
  785.     appname.gl.                (instance prefix)
  786.     Appname.GL.                (class prefix)
  787.  
  788.   where appname and Appname are derived from the argument to the GL
  789.   program's first call to winopen(3G) upper case.
  790.  
  791.   For complete information see the man page for GLRESOURCES.
  792.  
  793. ------------------------------
  794.  
  795. Subject:   -24- How can I know what resources I can set for an
  796.                 application?
  797. Date: 07 May 93 00:00:01 EST
  798.  
  799.   The most common place to find resource variables for a particular
  800.   application is in the man page for that application.
  801.  
  802.   For example, take a look at the man page for `xwsh'.  Look for the
  803.   section heading called `RESOURCES'.  This section lists each resource
  804.   for `xwsh', and in some cases, the valid values for that resource.
  805.  
  806.   Also, many major applications are built on top of the Xt toolkit.
  807.   There are standard resources that these applications recognize. For a
  808.   more complete description, see one of the books on Xt listed in the
  809.   bibliography.
  810.  
  811. ------------------------------
  812.  
  813. Subject:   -25- What is a good approach to take in looking for
  814.                 resources?
  815. Date: 07 May 93 00:00:01 EST
  816.  
  817.   The following is a recommended list  of steps to take when searching
  818.   for a resource, binding, behavior, etc.
  819.  
  820.    1) Look in the 4.0 Transition Guide.
  821.    2) Look in /usr/tutor/Customize.
  822.    3) Look in /usr/demos.
  823.    4) Look in ~4Dgifts.  (Available with the development option.)
  824.    5) If the client you are interested in is a GL client, see the
  825.       man page for GLRESOURCES.
  826.    6) Look in /usr/lib/X11/app-defaults/ClientName.
  827.    7) Look in /usr/lib/X11/system.* .
  828.    8) Look through the man page for the client you are interested in.
  829.    9) Look in O'Reilly & Associates Vol. III. It has many gems
  830.       pertaining to standard X clients.
  831.   10) Look in the documentation that came with your application.
  832.   11) Look in the OSF Motif manuals.
  833.   12) Post to comp.windows.x if you can not find
  834.       an answer using steps 1 through 11.
  835.  
  836. ------------------------------
  837.  
  838. Subject:   -26- What is the precedence for resource files?
  839. Date: 07 May 93 00:00:01 EST
  840.  
  841.   The following list indicates the weight of set resources.
  842.   Items at the top have the greatest weight.
  843.  
  844.   1) Hard coded values for resources.
  845.   2) Command line arguments.
  846.   3) Resources pointed to by $XENVIRONMENT.
  847.   4) Resource values loaded into the Resource Data Base via xrdb.
  848.   5) Resources pointed to by other environment variables :
  849.  
  850.      IF $XUSERFILESEARCHPATH is set
  851.  
  852.        then it contains a list of directories to search.
  853.  
  854.      ELSE IF $XAPPLRESDIR is set
  855.  
  856.        it contains a single directory, and a short list of related
  857.        directories (e.g. adjusted for language) is where resource files
  858.        must be found.
  859.  
  860.      ELSE
  861.  
  862.        Look in a short list of places related to $HOME (e.g. language
  863.        adjusted). This includes files in $HOME that have the name of
  864.        the class of the application.
  865.  
  866.   6) Resource values set in $HOME/.Xdefaults, provided that the
  867.      RESOURCE_MANAGER property hasn't been set via the xrdb command.
  868.      (see the third paragraph in the xrdb man page)
  869.   7) Values set in /usr/lib/X11/app-defaults/*.
  870.   8) Values set through through the application's fall back mechanism.
  871.  
  872. ------------------------------
  873.  
  874. Subject:   -27- Why do long resources cause X to crash mysteriously in
  875.                 IRIX 5.2?
  876. Date: 13 Nov 94 00:00:01 EST
  877.  
  878.   Get patch 36 from the TAC.
  879.  
  880. ------------------------------
  881.  
  882. Subject:   -28- 4DWM
  883. Date: 15 May 94 00:00:01 EST
  884.  
  885.   This section discusses the 4D Window Manager.
  886.  
  887. ------------------------------
  888.  
  889. Subject:   -29- Where can I learn more about the Window Manager?
  890. Date: 07 May 93 00:00:01 EST
  891.  
  892.   The man pages for 4Dwm and mwm contain a wealth of information on the
  893.   window manager. There are also online files. You may want to read
  894.   /usr/tutor/Customize/example.4Dwmrc (IRIX 4.0.x only) as well as
  895.   /usr/people/4Dgifts/.4Dwmrc (if you have the IDO option).  The
  896.   OSF/Motif manuals listed in the bibliography are also good places to
  897.   find information. (4Dwm is based on mwm).
  898.  
  899. ------------------------------
  900.  
  901. Subject:   -30- What files affect the window manager and what is their
  902.                 relationship to each other?
  903. Date: 07 May 93 00:00:01 EST
  904.  
  905.   1) ~/.4Dwmrc, if you have one
  906.   2) /usr/lib/X11/system.4Dwmrc
  907.   3) /usr/bin/X11/4Dwm
  908.   4) /usr/lib/X11/app-defaults/4Dwm
  909.   5) ~/.Xdefaults (or wherever you set resources)
  910.  
  911.   When 4Dwm is started, it looks for ~/.4Dwmrc. If it does not exist,
  912.   it looks at /usr/lib/X11/system.4Dwmrc. The definitions for button
  913.   bindings, menus, etc are contained in these files. For a better
  914.   description of bindings, look in /usr/tutor/Customize/example.4Dwmrc
  915.   and /usr/people/ 4Dgifts/.4Dwmrc. Also see the man pages for 4Dwm.
  916.  
  917.   The resource set for the bindings will actually "choose" which
  918.   binding definition is set.
  919.  
  920. ------------------------------
  921.  
  922. Subject:   -31- Do I need my own .4Dwmrc file?
  923. Date: 07 May 93 00:00:01 EST
  924.  
  925.   Not necessarily. As mentioned in the previous question, actual
  926.   bindings are determined by resource names. If there is a binding
  927.   definition in /usr/lib/X11/system.4Dwmrc that you like, you may
  928.   choose it by setting the appropriate resource.
  929.  
  930. ------------------------------
  931.  
  932. Subject:   -32- Can I run a different window manager?
  933. Date: 07 May 93 00:00:01 EST
  934.  
  935.   IRIX has 4Dwm, mwm, twm, and uwm. However, GL programs are guaranteed
  936.   to work only under 4Dwm.
  937.  
  938. ------------------------------
  939.  
  940. Subject:   -33- How can I choose a different window manager as the
  941.                 default?
  942. Date: 07 May 93 00:00:01 EST
  943.  
  944.   You must use a .xsession file and explicitly invoke the window
  945.   manager and any other applications you want to use, such as
  946.   'toolchest' and 'xwsh'.
  947.  
  948.   After making this change, you may only be able to log out by using
  949.   the "Log Out" selection in the toolchest, or by executing
  950.   /usr/bin/X11/endsession.
  951.  
  952.   Here are the contents of a sample .xsession file:
  953.  
  954.       xhost + &
  955.       toolchest -name ToolChest > /dev/console 2&>1 &
  956.       winterm -bg red &
  957.       winterm -bg blue &
  958.       mwm > /dev/console 2&>1 &
  959.       /usr/bin/X11/reaper
  960.  
  961.   Note that 'reaper' is not put into the background.  When 'reaper'
  962.   exits you will be logged out.
  963.  
  964.   Alternatively, you can do the following steps:
  965.  
  966.   1. cp /usr/lib/X11/xdm/Xsession ~/.xsession
  967.  
  968.   2. Remove the lines in ~/.xsession that say:
  969.  
  970.      if [ -r $xsession -a "$0" != $xsession ]; then
  971.       if [ -x $xsession ]; then
  972.           exec $xsession
  973.       else
  974.           exec /bin/sh $xsession
  975.       fi
  976.      fi
  977.  
  978.   3. Change the line that says
  979.  
  980.      /usr/bin/X11/4Dwm >/dev/console 2>&1 &
  981.  
  982.      to
  983.  
  984.      /usr/bin/X11/mwm > /dev/console 2>&1 &
  985.  
  986. ------------------------------
  987.  
  988. Subject:   -34- How can I recover from a failed window manager
  989.                 customization attempt?
  990. Date: 07 May 93 00:00:01 EST
  991.  
  992.   If your attempt at customization leaves you in a state where buttons
  993.   and menus are no longer recognized, you can recover by pressing the
  994.   <Alt><CTRL><Shift><!>keys simultaneously. A menu appears that will
  995.   let you choose Motif, Iris, or user defaults. Choose either Motif or
  996.   Iris defaults and then push OK. This restarts the window manager to a
  997.   usable state.
  998.  
  999. ------------------------------
  1000.  
  1001. Subject:   -35- Why is an extra 4Dwm burning CPU in IRIX 4.0.x?
  1002. Date: 07 May 93 00:00:01 EST
  1003.  
  1004.   This multiple window manager problem is usually triggered by the
  1005.   "kill" feedback of the window manager when a user logs out.  The
  1006.   workaround for the problem is to remove the "kill" feedback.
  1007.  
  1008.   The "kill" feedback is controlled by the resource "showFeedback."
  1009.   For 4Dwm, this resource is defined in /usr/lib/X11/app-defaults/4DWm
  1010.   as:
  1011.  
  1012.     *showFeedback:       behavior restart quit kill
  1013.  
  1014.   Modify the resource to read:
  1015.  
  1016.     *showFeedback:       behavior restart quit
  1017.  
  1018.   For mwm, set a "showFeedback" resource that does not include the
  1019.   "kill" feedback in /usr/lib/X11/app-defaults/Mwm.  A sample setting
  1020.   is:
  1021.  
  1022.     Mwm*showFeedback:  move placement resize behavior restart quit
  1023.  
  1024. ------------------------------
  1025.  
  1026. Subject:   -36- Why doesn't the window manager's "Log Out" routine work
  1027.                 in IRIX 4.0.5?
  1028. Date: 09 Jan 94 00:00:01 CST
  1029.  
  1030.   "Log Out" runs 'endsession', which under some versions of IRIX 4.0.5
  1031.   does not work if your hostname contains a number. Fortunately,
  1032.   'endsession' is a script, and you can fix it by changing the line
  1033.  
  1034.       PROP_DISPLAY=`expr $DISPLAY : '\(.*\).[1-9]' \| $DISPLAY`
  1035.  
  1036.   to
  1037.  
  1038.       PROP_DISPLAY=`expr $DISPLAY : '\(.*\)\.[1-9]' \| $DISPLAY`
  1039.  
  1040.   i.e. just add a backslash before the second period.
  1041.  
  1042. ------------------------------
  1043.  
  1044. Subject:   -37- ADMINISTRATION
  1045. Date: 15 May 94 00:00:01 EST
  1046.  
  1047.   This section describes how to start and stop parts of the graphics
  1048.   system in various funky ways.
  1049.  
  1050. ------------------------------
  1051.  
  1052. Subject:   -38- How can I log into pandora/clogin without bringing up
  1053.                 graphics?
  1054. Date: 07 May 93 00:00:01 EST
  1055.  
  1056.   Add the magic word 'failsafe' after your username. E.g. to log in as
  1057.   root without graphics, you'd type 'root failsafe', whack Enter, and
  1058.   type your password.
  1059.  
  1060. ------------------------------
  1061.  
  1062. Subject:   -39- How can I restart the console?
  1063. Date: 07 May 93 00:00:01 EST
  1064.  
  1065.   Use /usr/sbin/startconsole. 'startconsole' and 'winterm' (which
  1066.   'startconsole' calls) are scripts, so you can see how they do it.
  1067.  
  1068. ------------------------------
  1069.  
  1070. Subject:   -40- How can I start and stop the graphics system?
  1071. Date: 07 May 93 00:00:01 EST
  1072.  
  1073.   Use /usr/gfx/startgfx and /usr/gfx/stopgfx.  Be aware that stopgfx
  1074.   will kill any active windows and log you out.
  1075.  
  1076. ------------------------------
  1077.  
  1078. Subject:   -41- How can I kill the X server without logging in or
  1079.                 rebooting?
  1080. Date: 22 Jan 94 00:00:01 EST
  1081.  
  1082.   Hold down the left-Control, left-Shift, F12 and keypad slash keys.
  1083.   This is fondly known as the "Vulcan Death Grip".
  1084.  
  1085. ------------------------------
  1086.  
  1087. Subject:   -42- How can I run 'xinit' manually, rather than
  1088.                 automatically from 'xdm'?
  1089. Date: 07 May 93 00:00:01 EST
  1090.  
  1091.   By doing the following, which will affect all users:
  1092.  
  1093.   1) log in as root
  1094.   2) Type:
  1095.      /usr/gfx/stopgfx
  1096.      chkconfig xdm off.
  1097.  
  1098.   3) all users need to copy /usr/bin/X11/X to their home directory
  1099.      (renaming the file to .xserverrc), removing the if test for
  1100.      windowsystem, OR be familiar enough with xinit to have an
  1101.      alternate command line.
  1102.   4) transfer all startup programs from .xsession/.sgisession to
  1103.      .xinitrc.
  1104.   5) the last program to start from .xinitrc must not exit.  When this
  1105.      one exits, the session terminates.
  1106.  
  1107. ------------------------------
  1108.  
  1109. Subject:   -43- How can I start X on a remote host with no users logged
  1110.                 in?
  1111. Date: 07 May 93 00:00:01 EST
  1112.  
  1113.   This example starts up an xclock on the remote system.  The easy way
  1114.   to test this for now is to rlogin to the system and type the
  1115.   commands.  Once something works you can write some shell scripts and
  1116.   use rsh to run them:
  1117.  
  1118.   hydra is being used to login to oscar and start graphics on oscar.
  1119.   oscar is displaying the pandora login when this is done:
  1120.  
  1121.   hydra 2% rlogin oscar -l root
  1122.   oscar 1# /usr/gfx/stopgfx     (screen blanks)
  1123.   oscar 2# chkconfig windowsystem on
  1124.   oscar 3# setenv DISPLAY :0.0  (display on local screen)
  1125.   oscar 4# /usr/bin/X11/X &  (start Xsgi)
  1126.   oscar 5# xclock &  (clock is displayed)
  1127.  
  1128.   To clean up:
  1129.  
  1130.   oscar 6# /usr/gfx/stopgfx     (screen blanks)
  1131.   oscar 7# /usr/gfx/startgfx  (re-start pandora)
  1132.  
  1133. ------------------------------
  1134.  
  1135. Subject:   -44- IMAGE FILES
  1136. Date: 15 May 94 00:00:01 EST
  1137.  
  1138.   This section discusses image files and formats.
  1139.  
  1140. ------------------------------
  1141.  
  1142. Subject:   -45- How can I convert images to and from other formats?
  1143. Date: 20 May 94 00:00:01 EST
  1144.  
  1145.   IRIX comes with several tools which convert images to or from SGI's
  1146.   RGB format.  The executables are part of the eoe2.sw.imagetools
  1147.   subsystem, and include:
  1148.  
  1149.   fromalias - convert an Alias image to an IRIS image
  1150.   frombin - create an RGB IRIS image file from a binary dump of image data
  1151.   fromcmap - convert a color map into an image with one scanline
  1152.   fromcube - convert a Cubicomp/Vertigo image file to IRIS format
  1153.   fromdi - convert an old .di dithered image into an IRIS image
  1154.   fromface - convert a UNIX faceserver image into an IRIS image
  1155.   fromgif - convert a GIF image into an IRIS image
  1156.   frommac - convert a MacPaint image into an IRIS image
  1157.   frompic - convert a MOVIE BYU .PIC image to an IRIS image
  1158.   fromppm - convert an image in Jef Poskanzer's format into an IRIS image
  1159.   fromrla - convert a Wavefront image to an IRIS image
  1160.   fromsun - convert a sun image into an IRIS image
  1161.   fromtarga - convert a targa image into an IRIS image
  1162.   fromxbm - convert an X Bitmap image into an IRIS image
  1163.   fromxud - convert an xwd file into an IRIS image
  1164.   fromxwd - convert an xwd file into an IRIS image
  1165.   fromyuv - convert an Abekas yuv image into an IRIS image
  1166.   toalias - convert an IRIS image to an Alias image
  1167.   toascii - convert an IRIS image to text characters
  1168.   tobin - convert an IRIS image to binary dump of pixel data
  1169.   tobw - convert an IRIS image to black and white
  1170.   togif - convert an IRIS image to a Compuserve GIF image
  1171.   tomac - convert an IRIS image to MacPaint format
  1172.   tonews - convert an IRIS image into NeWS format
  1173.   topict - convert an IRIS image to Macintosh PICT format
  1174.   toppm - convert an IRIS image file into Jef Poskanzer's ppm image format
  1175.   tops - convert an IRIS image to PostScript
  1176.   toscitex - Convert IRIS images into Scitex CT2T images
  1177.   tosun - convert an IRIS image to a sun raster file
  1178.   totarga - convert an IRIS image to a type 2 targa image
  1179.   toyuv - convert an IRIS image to yuv format
  1180.  
  1181.   The source for each of these tools is in the 4Dgifts
  1182.   dev.dev_sw.giftsfull subsystem and placed in the directory
  1183.   /usr/people/4Dgifts/iristools/imgtools.  Each also has a manpage.
  1184.  
  1185.   Similar tools for more formats ('frompict', 'frompixar', 'fromtiff',
  1186.   'fromutah', 'totiff', 'toutah' and 'toxbm' at last count), as well as
  1187.   some which come with IRIX and a few miscellaneous cool image editing
  1188.   tools, are in ftp.sgi.com:/graphics/bin/. 'fromjpeg' and 'tojpeg' can
  1189.   be found in explorer.dgp.toronto.edu:/pub/sgi/sgijpeg/.
  1190.   swedishchef.lerc.nasa.gov:/ has 'fromvicar' in
  1191.   /image/conversion/from/, 'tocolps' and 'topcl' in
  1192.   /image/conversion/to/ and many other image- related tools in nearby
  1193.   directories.
  1194.  
  1195.   Finally, 'imgworks' (in the imgtools.sw.tools subsystem) understands
  1196.   RGB, TIFF and FIT formats, and several freeware programs including
  1197.   SDSC's 'imtools' (in
  1198.   ftp.sdsc.edu:/pub/sdsc/graphics/imtools/sgi_4d/), 'xv' (in
  1199.   ftp.cis.upenn.edu:/pub/xv/) and ImageMagick (in
  1200.   ftp.x.org:/contrib/applications/ImageMagick/) work on SGIs and
  1201.   understand SGI's RGB format as well as many other formats.
  1202.  
  1203. ------------------------------
  1204.  
  1205. Subject:   -46- What is the format of SGI's RGB files?
  1206. Date: 30 Apr 94 00:00:01 EST
  1207.  
  1208.   Read ftp.sgi.com:/graphics/SGIIMAGESPEC.
  1209.  
  1210. ------------------------------
  1211.  
  1212. Subject:   -47- How can I compress RGB bitmaps?
  1213. Date: 07 May 93 00:00:01 EST
  1214.  
  1215.   Use /usr/sbin/rle, which is part of eoe2.sw.imagetools.
  1216.  
  1217. ------------------------------
  1218.  
  1219. Subject:   -48- How can I make a screen dump?
  1220. Date: 13 Nov 94 00:00:01 EST
  1221.  
  1222.   Use the utilities 'imgsnap' (IRIX 4.0.x only), 'scrsave', 'snapshot'
  1223.   or 'xwd'. All have manpages. 'imgsnap' is in the imgtools.sw.tools
  1224.   subsystem, 'scrsave' and 'snapshot' are in the eoe2.sw.gltools
  1225.   subsystem, 'xwd' is in x_eoe.sw.Xapps and their manpages are in the
  1226.   respective *.man.* subsystems.
  1227.  
  1228.   From within a GL program, you should call readdisplay().  For an
  1229.   example look at ~4Dgifts/iristools/imgtools/scrsave.c.
  1230.  
  1231. ------------------------------
  1232.  
  1233. Subject:   -49- PROGRAMMING
  1234. Date: 15 May 94 00:00:01 EST
  1235.  
  1236.   This section discusses graphics programming. See the apps, audio and
  1237.   movie FAQs for general, audio and movie programming issues and the
  1238. ! impressario, inventor and performer FAQs for discussions of those
  1239.   packages.
  1240.  
  1241. ------------------------------
  1242.  
  1243. Subject:   -50- Can I use 4Dgifts code in my application?
  1244. Date: 07 May 93 00:00:01 EST
  1245.  
  1246.   Yes.  The 4Dgifts are a "gift" and developers are welcome to use the
  1247.   code.  However, SGI does not support the code in 4Dgifts.  Note that
  1248.   certain restrictions apply.  Please read the copyright statement in
  1249.   ~4Dgifts/README.Copyright.
  1250.  
  1251. ------------------------------
  1252.  
  1253. Subject:   -51- What does ERR_WMANIPC mean?
  1254. Date: 07 May 93 00:00:01 EST
  1255.  
  1256.   The "WMAN" in that message means "window manager."  However, this no
  1257.   longer means "window manager" such as 4Dwm, but rather the entire X
  1258.   Window system.  The error means that the GL program triggered a fatal
  1259.   X error.
  1260.  
  1261.   A GL program can get an X error, because all GL programs are actually
  1262.   X clients.  When a GL program does a winopen(), libgl actually calls
  1263.   XCreateWindow, etc.)
  1264.  
  1265.   When a GL program gets an X error, libgl prints out these X errors
  1266.   using this error message:
  1267.  
  1268.       GL: X request = maj.min,  error code = ercode
  1269.  
  1270.   where
  1271.  
  1272.       maj = major request code that caused the error
  1273.       min = minor request code
  1274.       ercode = X error code
  1275.  
  1276.   This turns out to be easy to interpret, so long as the request was a
  1277.   core X protocol request (e.g., a CreateWindow request).  In that
  1278.   case:
  1279.  
  1280.       1. You can look up the major code in /usr/include/X11/Xproto.h.
  1281.       2. The minor code is not used.
  1282.       3. The X error code can be found in /usr/include/X11/X.h.
  1283.  
  1284.   As you can see in Xproto.h, the core X protocol requests have request
  1285.   codes <= 127.
  1286.  
  1287.   However, if maj > 127, then the request is an X extension request.
  1288.   Unfortunately, it can be difficult to interpret this unless you built
  1289.   your program with a debugging libgl.a (compiled with -g).  The reason
  1290.   is that for an X extension, the major request code and the starting
  1291.   error code are copied from the X server during client startup, and
  1292.   these codes are saved in variables inside libgl.  With a debugging
  1293.   libgl, these variables can be printed out from within a debugger,
  1294.   such as dbx.
  1295.  
  1296.   If the major code indicates an X Input extension request, then the
  1297.   minor numbers then tell the X input request type, and these are found
  1298.   in /usr/include/X11/extensions/XIproto.h.
  1299.  
  1300.   Finally, the X Input Extension uses 132 as its "starting error code."
  1301.   The possible errors are found in /usr/include/X11/extensions/XI.h,
  1302.   where they're defined like this:
  1303.  
  1304.       #define XI_BadDevice   0
  1305.       #define XI_BadEvent    1
  1306.       #define XI_BadMode     2
  1307.       #define XI_DeviceBusy  3
  1308.       #define XI_BadClass    4
  1309.  
  1310.   If you add 132 to these numbers, you get the error that's reported by
  1311.   the libgl error message.
  1312.  
  1313. ------------------------------
  1314.  
  1315. Subject:   -52- How can I translate screen (x,y) coords into world
  1316.                 (x,y,z) coords?
  1317. Date: 07 May 93 00:00:01 EST
  1318.  
  1319.   Check the manual page for mapw(3G) or mapw2(3G). mapw() returns a
  1320.   line into (x,y,z) space.
  1321.  
  1322. ------------------------------
  1323.  
  1324. Subject:   -53- How can I translate world (x,y,z) coords into screen
  1325.                 (x,y) coords?
  1326. Date: 07 May 93 00:00:01 EST
  1327.  
  1328.   There are two methods.  The first method is detailed in
  1329.   ~4Dgifts/examples/grafix/world2scrn.c, which is part of the
  1330.   dev.dev_sw.giftsfull package.  It multiplies the (x,y,z) vector into
  1331.   the current modeling and projection matrixes, and uses the result to
  1332.   interpolate based on the window size and position.
  1333.  
  1334.   The second method uses the current cursor position as a trick and is
  1335.   much simpler.  Use cmov() to set the cursor position to the point of
  1336.   interest in world space, then call getcpos() to return the cursor
  1337.   position in screen coordinates.  Note that if your entire viewport is
  1338.   off-screen, the results are undefined and you'll have to use the
  1339.   first method.
  1340.  
  1341.       float x,y,z;
  1342.       short x1, y1;
  1343.       
  1344.       cmov (x,y,z);
  1345.       getcpos (&x1, &y1);
  1346.  
  1347. ------------------------------
  1348.  
  1349. Subject:   -54- Why does nothing happen when I call mapcolor(index, R,
  1350.                 G, B)?
  1351. Date: 07 May 93 00:00:01 EST
  1352.  
  1353.   You either need to call glcompat(GLC_SLOWMAPCOLORS, TRUE) at the
  1354.   beginning of your program, or call gflush() after calling mapcolor.
  1355.  
  1356.   See the NOTES section in "man mapcolors" and also "man glcompat" for
  1357.   further info. (This may also be in the GL release notes)
  1358.  
  1359. ------------------------------
  1360.  
  1361. Subject:   -55- What's wrong with blink() in IRIX 4.0.x?
  1362. Date: 10 Jun 93 00:00:01 EST
  1363.  
  1364.   - blink() is broken all the way up through 4.0.5F, where blink() only
  1365.     blinks to black.
  1366.  
  1367.   - you can work-around this blink() problem by doing the following:
  1368.  
  1369.       blink(rate, index, red<<8, green<<8, blue<<8)
  1370.  
  1371.   - ~4Dgifts/examples/glpg/ch04/blinker.c has three main problems:
  1372.  
  1373.       - it doesn't do the above work-around.
  1374.       - it doesn't do a gflush after mapping colors.
  1375.       - it doesn't turn blinking off initially.
  1376.  
  1377.   - what happens is that if a program starts anything blinking and
  1378.     exits without ever turning blinking off with blink(-1, 0, 0, 0, 0)
  1379.     then the next program to attempt blinking will not be able to
  1380.     blink.  this happens if for instance you close the blinker window
  1381.     before its 10 second sleep() has completed.
  1382.  
  1383.   - a simple idea for a work-around for this problem: programs which do
  1384.     blinking should turn their blinking on when they have focus; they
  1385.     should turn all blinking off when they lose focus.  This is not
  1386.     perfect but is a plausible attempt at sharing the 20 blinking
  1387.     system-wide colormap entries.
  1388.  
  1389.   Here is a copy of ~4Dgifts/examples/glpg/ch04/blinker.c that contains
  1390.   the above workarounds, except for input-focus:
  1391.  
  1392.   #include <gl/gl.h>
  1393.  
  1394.   #define MAXBLINKS       20    /* maximum number of blinking entries */
  1395.   #define FIRSTBLINKCI    64    /* avoid the first 64 colors */
  1396.  
  1397.   main()
  1398.   {
  1399.       int i;
  1400.  
  1401.       prefsize(400, 400);
  1402.       winopen("blinker");
  1403.       ortho2(-0.5, 20.0*MAXBLINKS + 9.5, -0.5, 500.5);
  1404.       color(BLACK);
  1405.       clear();
  1406.  
  1407.       /* always turn blinking off before calling 'blink' */
  1408.       blink (-1, 0, 0, 0, 0);
  1409.  
  1410.       for (i = MAXBLINKS - 1; i >= 0 ; i--) {
  1411.       mapcolor(i + FIRSTBLINKCI, 255, 255, 255);
  1412.       /* always call gflush() after mapcolors() */
  1413.       gflush();
  1414.       color(i + FIRSTBLINKCI);
  1415.       sboxfi(i*20 + 10, 10, i*20 + 20, 490);
  1416.       /* GL bug in blink -- must left-shift r,g,b values */
  1417.       blink(i + 1, i + FIRSTBLINKCI, 255 << 8, 0 << 8, 0 << 8);
  1418.       }
  1419.       sleep(10);
  1420.       blink(-1, 0, 0, 0, 0);      /* stop all blinking */
  1421.       gexit();
  1422.       return 0;
  1423.   }
  1424.  
  1425. ------------------------------
  1426.  
  1427. Subject:   -56- Why can't 'cc' find some standard Xwindows functions?
  1428. Date: 14 May 94 00:00:01 EST
  1429.  
  1430.   You may be linking X libraries, which have complex interdependencies,
  1431.   in the wrong order. Mark Kilgard <mjk@hoot.asd.sgi.com> provided this
  1432.   handy chart:
  1433.  
  1434.   libXm--libXirisw
  1435.                   \
  1436.                    libXt--libXmu--libgl--libXi--libXext--libX11
  1437.                   /
  1438.             libXaw
  1439.  
  1440.   Libraries should be listed in the same order on the cc or ld command
  1441.   line, left to right, as they appear above. If you don't use routines
  1442.   from a library, of course, you don't need it.
  1443.  
  1444. ------------------------------
  1445.  
  1446. Subject:   -57- Where is the library /usr/lib/libgl_s.a for my R4000
  1447.                 Indigo running IRIX 4.0.5F?
  1448. Date: 07 May 93 00:00:01 EST
  1449.  
  1450.   It's in the "maint" software, in the maint_gl_x_dev package.
  1451.  
  1452. ------------------------------
  1453.  
  1454. Subject:   -58- What is a GL widget?
  1455. Date: 10 Jun 93 00:00:01 EST
  1456.  
  1457.   GL widget refers to the GlxDraw (generic) and GlxMDraw (Motif)
  1458.   widgets that allow you to embed GL windows in Xt-based programs.  To
  1459.   embed a GL windows in X-based programs is frequently called
  1460.   "Mixed-model" or "GLX" programming.
  1461.  
  1462.   There are several examples of mixed-model programming in the
  1463.   directory /usr/people/4Dgifts/examples/GLX.
  1464.  
  1465. ------------------------------
  1466.  
  1467. Subject:   -59- I'm using the GlxMDraw widget and it doesn't seem that
  1468.                 colors are being installed correctly.  Overlays in the
  1469.                 GlxMDraw widget are displayed in red and gray instead of
  1470.                 the colors I specify.  What's wrong?
  1471. Date: 10 Jun 93 00:00:01 EST
  1472.  
  1473.   The window manager must be directed to install all appropriate
  1474.   colormaps.  Use the XSetWMColormapWindows() call to do this -- list
  1475.   one window for each colormap to be installed plus the top level
  1476.   window.  If using overlays, include the overlay window as well as the
  1477.   normal GL window.
  1478.  
  1479.   If your window is TrueColor, you should still install the appropriate
  1480.   colormap, as Indigo TrueColor is simulated using a colormap.
  1481.  
  1482. ------------------------------
  1483.  
  1484. Subject:   -60- Is there a way to switch between single and double
  1485.                 buffering within a GL widget on the fly?
  1486. Date: 10 Jun 93 00:00:01 EST
  1487.  
  1488.   There is no way to switch between single and double buffered mode
  1489.   within the same window. (In X, this would mean changing the depth,
  1490.   which is not allowed.)
  1491.  
  1492.   To simulate this, you can create two GL widgets: a double buffered GL
  1493.   widget and a single buffered GL widget.  When it is time to change
  1494.   the buffering mode, restack the windows so that the appropriate one
  1495.   is on top. If the two windows are created with a common parent, they
  1496.   move together when the parent is moved.
  1497.  
  1498.   For non-mixed mode applications, the GL performs this switching when
  1499.   you call gconfig().
  1500.  
  1501. ------------------------------
  1502.  
  1503. Subject:   -61- Why doesn't my X server use backing store? How can I
  1504.                 turn it on?
  1505. Date: 12 Feb 94 00:00:01 EST
  1506.  
  1507.   Mark Kilgard of SGI <mjk@hoot.asd.sgi.com> writes,
  1508.   SGI ships its X server with backing store disabled.  If you edit
  1509.   /usr/lib/X11/xdm/Xservers and remove the -bs option, then restart the
  1510.   X server, backing store will be available.
  1511.  
  1512.   The reason for not turning on backing store by default is two-fold.
  1513.  
  1514.   1) In IRIX 4.0.X the code for managing overlay planes didn't properly
  1515.      take overlays into account so backing store doesn't work if you
  1516.      have overlay windows on the screen. This is fixed in IRIX 5.x.
  1517.  
  1518.   2) In most cases, backing store hurts your performance.  It cases ALL
  1519.      X rendering operations to make an extra (small) traversal through
  1520.      backing store code even if backing store isn't in use.  Also when
  1521.      backing store is in use, it tends to grow the X server since a
  1522.      large amount of memory can easily be used to maintain backing
  1523.      store.
  1524.  
  1525.   One alternative to backing store is to render your image to a pixmap
  1526.   and then blit from the pixmap to the screen in response to expose
  1527.   events.  This will stress the X server a great deal less than using
  1528.   backing store.  Additionally, make sure you are compressing expose
  1529.   events when you redraw.
  1530.  
  1531. ------------------------------
  1532.  
  1533. Subject:   -62- What is "/dev/tport" used for?
  1534. Date: 26 May 93 00:00:01 CST
  1535.  
  1536.   Mark Stadler (mds@sgi.com) says:
  1537.   /dev/tport is a streams-based tty device driver which can be in one
  1538.   of 2 modes:
  1539.  
  1540.   - when X is not running, /dev/tport gets its input from the graphics
  1541.     keyboard and images in the frame buffer (textport mode).  This mode
  1542.     is only intended to be used in single-user mode or during
  1543.     transitional periods when the X server is not running.
  1544.  
  1545.   - when X is running, /dev/tport doesn't get any input and generates
  1546.     no output.  Any programs or shells using /dev/tport hang on reads
  1547.     and toss writes.
  1548.  
  1549.   Kind of a strange device.  But it makes more sense with a clear
  1550.   understanding of how /dev/console works.
  1551.  
  1552.   /dev/console is kind of like a terminal switch box.  Rather than
  1553.   switching physical rs232 cables, we direct console output onto the
  1554.   output stream of other streams-based devices who request such
  1555.   behavior with TIOCCONS ioctl.
  1556.  
  1557.   By default, /dev/console directs its output to /dev/tport.  In the
  1558.   absence of a windowing system this causes console output (including
  1559.   kernel prints) to show up on the textport in front of you.
  1560.  
  1561.   Once the window system is started, the /dev/tport is no longer
  1562.   visible.  Thus the console is no longer visible.  At this point, a
  1563.   terminal emulation window (using streams based ttys) can issue the
  1564.   TIOCCONS ioctl to cause console output (including kernel printfs) to
  1565.   show up in the emulation in the window in front of you.
  1566.  
  1567.   Note that when you bring the window system down, /dev/tport is still
  1568.   there with the same session it started with and the console output
  1569.   redirected back to it again.
  1570.  
  1571. ------------------------------
  1572.  
  1573. Subject:   -63- BUGS AND PROBLEMS
  1574. Date: 15 May 94 00:00:01 EST
  1575.  
  1576.   This section discusses real and apparent bugs and problems we haven't
  1577.   covered already.
  1578.  
  1579. ------------------------------
  1580.  
  1581. Subject:   -64- Why do I get a "Broken Pipe" error when I close an X
  1582.                 client window?
  1583. Date: 10 Jun 93 00:00:01 EST
  1584.  
  1585.   Typically the error message looks like:  XIO: fatal IO error 32
  1586.   (Broken pipe) on X server ":0.0" after 214 requests (214 known
  1587.   processed) with 0 events remaining.  The connection was probably
  1588.   broken by a server shutdown or KillClient.
  1589.  
  1590.   The Window Manager is reporting that the pipe for your X client has
  1591.   been broken.  This is normal when an X client exits.  There is
  1592.   nothing wrong with your system. This message will also occur when the
  1593.   system is shut down.  This is not an error condition and no core
  1594.   files are produced.
  1595.  
  1596. ------------------------------
  1597.  
  1598. Subject:   -65- What do the errors in my 'xdm-errors' file mean?
  1599. Date: 07 May 93 00:00:01 EST
  1600.  
  1601.   It depends on the error message, obviously.  Some are:
  1602.  
  1603.     unable to load display mode, rnid = 196614, errno = 22
  1604.     Failed to unbind rn from clip, rnid = 3,errno = 22
  1605.     bogus window id in rrm request type(2)
  1606.  
  1607.   These are messages related to the communication between the rrm layer
  1608.   in the kernel and the X server.  The messages usually occur when a GL
  1609.   window is being destroyed in a sequence that the X server did not
  1610.   expect.  They are quite benign.
  1611.  
  1612. ------------------------------
  1613.  
  1614. Subject:   -66- Why doesn't SGI's xlock lock my screen?
  1615. Date: 10 Jun 93 00:00:01 EST
  1616.  
  1617.   If you or the super-user don't have a password, xlock will not lock.
  1618.  
  1619.   Under IRIX 4.0.x, xlock is set up by default to act as if invoked
  1620.   with the "-nolock" option, which tells it not to lock the screen.  If
  1621.   you want force xlock to lock, do either of the following:
  1622.  
  1623.   a) Use the "+nolock" option when invoking xlock.  This means
  1624.      "not nolock" (the opposite of "-nolock").  For example:
  1625.  
  1626.      % xlock +nolock
  1627.  
  1628.   b) Add the following line to your ~/.Xdefaults file:
  1629.  
  1630.      XLock.nolock:    False
  1631.  
  1632.   In IRIX 5.x, the default behavior of xlock has been reversed, so
  1633.   xlock does indeed lock by default.  If you wish to keep the IRIX 4.x
  1634.   behavior, invoke xlock with the -nolock option.
  1635.  
  1636. ------------------------------
  1637.  
  1638. Subject:   -67- Sun XView applications like "mailtool" hang my X server
  1639.                 in IRIX 4.0.5.  They come up fine, but when I click on
  1640.                 them the server freezes.
  1641. Date: 07 May 93 00:00:01 EST
  1642.  
  1643.   Any XView application run under the Xsgi X11-server shipped in IRIX
  1644.   versions 4.0.5A through 4.0.5G will lock the X Server on the first
  1645.   mouse click and will not release it until killed from somewhere
  1646.   else.  Fortunately there is a workaround:
  1647.  
  1648.   a) Run the application with '-Wfsdb' on the command line.
  1649.      Alternatively you could use '-fullscreendebug'.  For example:
  1650.  
  1651.      % mailtool -Wfsdb
  1652.  
  1653.   b) If you have the sources, add
  1654.  
  1655.        extern int fullscreendebug;
  1656.  
  1657.      before main() and
  1658.  
  1659.        fullscreendebug = 1;
  1660.  
  1661.      after the xv_init() call.  This forces the program to set this
  1662.      flag in any case - even when run with non-SGI X servers.  It
  1663.      releases you of the danger of omitting -Wfsdb and locking your
  1664.      screen.
  1665.  
  1666.   c) if the program uses the 'fullscreen' package, you might add
  1667.  
  1668.          Fullscreen.Debug: True
  1669.  
  1670.      in $HOME/.Xresources or specify this resource on the command
  1671.      line.  This flag currently disables grabs in both the 'window' and
  1672.      the 'fullscreen' package, but is only set from resources in the
  1673.      'fullscreen' package.
  1674.  
  1675. ------------------------------
  1676.  
  1677. Subject:   -68- Why can't I log into Pandora in IRIX 4.0.1?
  1678. Date: 07 May 93 00:00:01 EST
  1679.  
  1680.   The problem is caused by an incorrect shutdown.  When you log out,
  1681.   xdm runs /usr/sbin/gamma and writes the current value to
  1682.   /etc/config/system.glGammaVal.  IRIX buffers this data in main memory
  1683.   in the buffer cache.  If the system is powered off right after
  1684.   logout, the data is not written to the file.
  1685.  
  1686.   a) Login to your system as root, either via the network or
  1687.      by taking the machine down to single-user mode.
  1688.  
  1689.   b) enter these commands at the # prompt:
  1690.  
  1691.      # cd /etc/config
  1692.      # cat system.glGammaVal
  1693.  
  1694.   If the cat command returns a value of 1.7000, contact your technical
  1695.   support provider for additional troubleshooting.  If the command
  1696.   returns nothing (empty file) or "0", it means the problem can be
  1697.   fixed by entering the following command:
  1698.  
  1699.     # /bin/rm system.glGammaVal
  1700.     # /bin/echo "1.7" > system.glGammaVal
  1701.  
  1702.   Check your work:
  1703.  
  1704.     # cat system.glGammaVal
  1705.  
  1706.   The command above should now return 1.7.
  1707.  
  1708.   Your login should now be successful. If you edited the file while
  1709.   Pandora was running, you'll find the first login attempt will fail,
  1710.   but any later attempts will be successful. After the first login
  1711.   attempt, Pandora will read in the correct gamma value.
  1712.  
  1713. ------------------------------
  1714.  
  1715. Subject:   -69- Pandora won't come up, and /usr/adm/SYSLOG says
  1716.                 "helvetica font missing"
  1717. Date: 07 May 93 00:00:01 EST
  1718.  
  1719.   It appears that the subsystem "eoe2.sw.fonts" did not get loaded.
  1720.   Re-install the subsystem using the following sequence from 'inst':
  1721.  
  1722.   1) type "inst" or boot the mini-root, as documented in Section 4.5
  1723.      of the "IRIS Software Installation Guide"
  1724.   2) keep *
  1725.   3) set neweroverride on
  1726.   4) install eoe2.sw.fonts
  1727.   5) exit
  1728.  
  1729. ------------------------------
  1730.  
  1731. Subject:   -70- Why does the X server sometimes abort when I log out in
  1732.                 IRIX 5.0.1 and IRIX 5.1?
  1733. Date: 01 Oct 93 00:00:01 EST
  1734.  
  1735.   BACKGROUND:  Both problems are related to resetting of the X server.
  1736.   Normally the X server process is spawned by xdm (the X Display
  1737.   Manger).  The X server process continues to run after every login and
  1738.   logout of the graphics head; the server simply resets to its initial
  1739.   state every time someone logs out.  In X server terminology, the X
  1740.   server goes through multiple generations.
  1741.  
  1742.   PROBLEM 1:  The dynamically loadable Display PostScript extension has
  1743.   a bug where it does not properly reset the X server state on server
  1744.   reset (ie, generations other than the first).
  1745.  
  1746.   The problem only occurs if you have dps_eoe.sw.xserver_ext (which
  1747.   contains /usr/lib/X11/dyDDX/xdps.so which is the dynamically loadable
  1748.   Display PostScript extension).  dps_eoe is installed by default.
  1749.  
  1750.   This problem affects all CPUs and graphics hardware.
  1751.  
  1752.   PROBLEM 2:  If the user logs out while any GL-based application (such
  1753.   as buttonfly, WorkSpace, jot, etc) is running, the server will not
  1754.   reset.
  1755.  
  1756.   Typically you will find errors in /usr/adm/SYSLOG similar to the
  1757.   following:
  1758.  
  1759.       date host xdm[pid]: IO Error in XOpenDisplay
  1760.       date host xdm[pid]: Display :0 cannot be opened
  1761.       date host xdm[pid]: Display :0 is being disabled
  1762.       date host xdm[pid]: Rescanning both config and servers files
  1763.  
  1764.   WORKAROUND:  As root, edit /usr/lib/X11/xdm/xdm-config and change the
  1765.   line
  1766.  
  1767.       DisplayManager._0.terminateServer:      False
  1768.  
  1769.   to
  1770.  
  1771.       DisplayManager._0.terminateServer:      True
  1772.  
  1773.   (Please note that the contents of xdm-config are case-sensitive.)
  1774.   Then restart the window system (/usr/gfx/stopgfx; /usr/gfx/startgfx)
  1775.  
  1776.   If the above workaround doesn't work, try setting
  1777.  
  1778.       DisplayManager._0.startAttempts:        1
  1779.  
  1780.   to
  1781.  
  1782.       DisplayManager._0.startAttempts:        4
  1783.  
  1784.   This change forces xdm to try to start the X server up to four times,
  1785.   if the first three fail.
  1786.  
  1787. ------------------------------
  1788.  
  1789. Subject:   -71- After running a few programs, the colors change as the
  1790.                 cursor moves. The colors are usually all wrong in other
  1791.                 windows.
  1792. Date: 07 May 93 00:00:01 EST
  1793.  
  1794.   This is known as colormap flashing. It is caused by the server
  1795.   maintaining 2 separate colormaps, one for GL windows and one for X
  1796.   windows.  As the cursor moves around, the window manager will install
  1797.   the correct colormap for each window.  This will cause colors to be
  1798.   wrong in other windows.  For more information on colormaps and
  1799.   installation please see the Xlib Programming manual, chapter 7 (Vol I
  1800.   of the O'Reilly series).
  1801.  
  1802.   You can sometimes avoid colormap flashing by configuring your X
  1803.   Server to use a 12-bit or 24-bit visual by default.
  1804.  
  1805. ------------------------------
  1806.  
  1807. Subject:   -72- How can I make my X Server use a 12-bit PseudoColor, 12-
  1808.                 bit TrueColor or 24-bit TrueColor visual by default?
  1809. Date: 07 May 93 00:00:01 EST
  1810.  
  1811.   By default, the SGI X Server is configured to use an 8-bit
  1812.   PseudoColor visual.  X-based applications can request other visuals
  1813.   directly if they are available.  Alternatively, you can change the
  1814.   default visual by performing the following steps:
  1815.  
  1816.   a) Run "/usr/bin/X11/xdpyinfo" and check that your server is
  1817.      capable of using a 12-bit or 24-bit visual.  If it is,
  1818.      you will see lines similar to the following:
  1819.  
  1820.      visual id, max buffers, depth:    0x28, 0, 12
  1821.      visual id, max buffers, depth:    0x29, 0, 12
  1822.      visual id, max buffers, depth:    0x2a, 0, 24
  1823.  
  1824.      The last number on each line represents the number of bits
  1825.      available for that visual.
  1826.  
  1827.   b) Log in as root
  1828.  
  1829.   c) Edit the file /usr/lib/X11/xdm/Xservers.  By default it
  1830.      will contain the string:
  1831.        :0 secure /usr/bin/X11/X -bs -c -pseudomap 4sight
  1832.      for a 24-bit TrueColor visual change it to:
  1833.        :0 secure /usr/bin/X11/X -bs -c -class TrueColor -depth 24
  1834.      for a 12-bit PseudoColor visual change it to:
  1835.        :0 secure /usr/bin/X11/X -bs -c -class PseudoColor -depth 12
  1836.  
  1837.   d) Restart your X server.  You can do this by invoking either
  1838.      of the following commands:
  1839.  
  1840.      % killall -TERM Xsgi
  1841.  
  1842.      % /usr/gfx/stopgfx; /usr/gfx/startgfx
  1843.  
  1844.   Note:  X Server visuals are an advanced topic; before making the
  1845.   above changes you should be aware that some 3rd-party and freeware
  1846.   applications might not gracefully adapt to an X Server which supplies
  1847.   anything but an 8-bit PseudoColor visual by default.
  1848.  
  1849. ------------------------------
  1850.  
  1851. Subject:   -73- When I try to run UIM/X uxserverd, I get an error
  1852.                 message saying, "license file has been modified, cannot
  1853.                 start the UIM/X license server".
  1854. Date: 07 May 93 00:00:01 EST
  1855.  
  1856.   You probably have been given a bad key.  The most frequent causes of
  1857.   incorrect keys have been incorrect capitalization and incorrect IP
  1858.   addresses.
  1859.  
  1860.   The program that generates the UIM/X key requires that the "host ID"
  1861.   (or IP address) be in hexadecimal format.  If you feed it the
  1862.   standard form of IP address (i.e., 123.45.678.90) it will generate
  1863.   the wrong key and will not complain.
  1864.  
  1865.   To ensure that you are is giving the correct information when
  1866.   requesting a UIM/X key, please do the following:
  1867.  
  1868.   Hostname:  Type in 'hostname' at the prompt, and be sure to say
  1869.   exactly what it says (including capitalization, if any).
  1870.  
  1871.   Host ID:  Type in 'hostid' at the prompt, and be sure to say exactly
  1872.   what it says.  You will be reading back a series of numbers of the
  1873.   form 0xc030c844.  The leading 0x indicates that the following number
  1874.   is hexadecimal.
  1875.  
  1876.   The key generating script is highly sensitive to capital letters.
  1877.   Make sure you confirm the case of the letters, both when getting the
  1878.   hostname/hostid and when having your key read back to you.
  1879.  
  1880.   If this still doesn't fix the problem, you may have mixed files
  1881.   between UIM/X 1.0 and 2.0.  Completely remove UIM/X, re-install it,
  1882.   and reproduce a Uimx2_0.license file with the correct information.
  1883.  
  1884. ------------------------------
  1885.  
  1886. Subject:   -74- MISCELLANEOUS
  1887. Date: 15 May 94 00:00:01 EST
  1888.  
  1889.   Everything else.
  1890.  
  1891. ------------------------------
  1892.  
  1893. Subject:   -75- What books about the X Window System and OSF/Motif do
  1894.                 you recommend?
  1895. Date: 07 May 93 00:00:01 EST
  1896.  
  1897.   Introductory Texts on the X Window System
  1898.  
  1899.   - O'Reilly and Associates Inc., "The Definitive Guides to the X
  1900.     Window System", by Valerie Quercia and Tim O'Reilly. Vol.  3, "X
  1901.     Window System User's Guide", Sebastopol, CA., 1988, 1989.
  1902.  
  1903.     Discusses being an end user of the X window system.  Covers topics
  1904.     like window manages, font specifications, standard X clients and
  1905.     resources.
  1906.  
  1907.   Texts on X Window System Programming
  1908.  
  1909.   - O'Reilly and Associates, Inc. "The Definitive Guides to the X
  1910.     Window System", by Adrian Nye. Vol. 1, "Xlib Programming Manual",
  1911.     Sebastopol, CA, 1990.
  1912.  
  1913.     Contains the introductory elements for programming with the Xlib,
  1914.     the lowest level of the X window system.  Discusses concepts such
  1915.     as X color capacities, windows, events, drawing primitives.
  1916.  
  1917.   - Young, Douglas A., "X Window Systems Programming and Applications
  1918.     with Xt" (OSF/Motif Edition). Prentice Hall. Englewood Cliffs, NJ.
  1919.     1990.
  1920.  
  1921.     A thorough book starting with the basics of programming with a
  1922.     toolkit though advanced topics.  Contains source code for several
  1923.     small complete applications.  (Source code for this book is also
  1924.     available on line in the /usr/src directory of the Motif
  1925.     Development option.)
  1926.  
  1927.   - O'Reilly and Associates Inc., "The Definitive Guides to the X
  1928.     Window System", by Adrian Nye and Tim O'Reilly. Vol. 4, "X Toolkit
  1929.     Intrinsics Programming Manual", Sebastopol, CA., 1990.
  1930.  
  1931.     Another reference for programming with the OSF/Motif toolkit.
  1932.     Covers topics including basic programming, widgets, resources, and
  1933.     more advanced topics.
  1934.  
  1935.   Reference Texts for the X Window System :
  1936.  
  1937.   - O'Reilly and Associates Inc., "The Definitive Guides to the X
  1938.     Window System", by Adrian Nye. Vol. 2, "Xlib Reference Manual",
  1939.     Sebastopol, CA., 1988.
  1940.  
  1941.     Complete reference for Xlib library routines.
  1942.  
  1943.   - Scheifler, Robert and James Gettys, X Window System, Second
  1944.     Edition, Digital Press, 1990.  ISBN 1-55558-050-5.
  1945.  
  1946.     Referred to as "the Bible" of Xlib and X Protocol reference.
  1947.  
  1948.   Reference Texts for the OSF/Motif Toolkit :
  1949.  
  1950.   - Open Software Foundation, "OSF/Motif Programmer's Guide". Release
  1951.     1.1, Prentice Hall. Englewood Cliffs, NJ. 1990.
  1952.  
  1953.     Exhaustive reference of every widget in the OSF/Motif library.
  1954.  
  1955.   - Asente, Paul J. and Ralph R. Swick. "X Window System Toolkit".
  1956.     X Version 11, Release 4. Digital Press. 1990.
  1957.  
  1958.     Very in-depth reference to the structure and operation of an X
  1959.     window system toolkit.
  1960.  
  1961. ------------------------------
  1962.  
  1963. Subject:   -76- Does the IRIX 5.2 Magic user environment display on an X
  1964.                 terminal?
  1965. Date: 30 Apr 94 00:00:01 EST
  1966.  
  1967.   Joel Tesler <joel@jellotrees.esd.sgi.com> says:  Although it is not
  1968.   officially supported, it should work in IRIX 5.2 MR (but not in the
  1969.   beta release).  There are some glitches.  You probably don't have to
  1970.   set the environment variable _NO_DESKTOP_IMAGES, but try it if you
  1971.   have problems.  There should be no reason to set _SGI_NO_REMOTE_GL.
  1972.  
  1973. ------------------------------
  1974.  
  1975. Subject:   -77- What about OpenGL?
  1976. Date: 22 Oct 94 00:00:01 EST
  1977.  
  1978.   It has its own newsgroup, comp.graphics.opengl, which has an FAQ,
  1979.   which is listed in the misc FAQ. The misc FAQ also points to an
  1980.   OpenGL WWW page.
  1981.  
  1982. ------------------------------
  1983.  
  1984. Subject:   -78- Which SGI machines can run OpenGL now? Which will in the
  1985.                 future?
  1986. Date: 12 Jun 94 00:00:01 EST
  1987.  
  1988.   OpenGL comes with IRIX 5.x. It supports Entry, XS, XS24, XZ, XL,
  1989.   Elan, Extreme, VTX, Reality Engine, and Reality Engine 2 graphics. A
  1990.   later version of OpenGL (sometime this year?) will support G, GT,
  1991.   GTX, VGX, and VGXT graphics.
  1992.  
  1993. ------------------------------
  1994.  
  1995. Subject: + -79- What's this about a copyright dispute over virtual desks
  1996.                 in Indigo Magic?
  1997. Date: 16 Dec 94 00:00:01 EST
  1998.  
  1999. + Xerox has a software patent which may cover the virtual desks which
  2000. + are part of Indigo Magic. It may blow over, or SGI may have to remove
  2001. + virtual desks from Indigo Magic or charge for them. IRIX 5.3 and 6.x
  2002. + include licensing code which will turn off virtual desks by 15 May
  2003. + 1995 unless SGI, pending a succesful resolution of the patent dispute,
  2004. + provides a licensing code to its customers. See chapter 1 of the
  2005. + desktop_eoe release notes for details.
  2006.  
  2007. ------------------------------
  2008.  
  2009. End of sgi/faq/graphics Digest
  2010. ******************************
  2011. -- 
  2012. The SGI FAQ group                                sgi-faq@viz.tamu.edu
  2013. Finger us for info on the SGI FAQs, or look in viz.tamu.edu:/pub/sgi.
  2014.  
  2015.  
  2016.